home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 176-200 / scopedisk186 / logg10 / quick_help.doc < prev    next >
Text File  |  1995-03-19  |  9KB  |  168 lines
  1.  
  2.                           QUICK HELP FILE FOR "LoGG 1.0"
  3.  
  4.                                  A. G. Kartsatos
  5.  
  6.  
  7.      1)  To run the program with most of the basic functions working, you 
  8. will need at least these files in your current "c" directory:
  9.  
  10.                       CD, LoGG.file, ENDCLI, STACK, RUN
  11.  
  12.      LoGG looks for the file "LoGG.file" in your current directory as well
  13. as your "c" directory.  The program will abort if it does not locate this
  14. file.  This is the file that contains the names of your drives, the 4 colors
  15. and the 48 user-definable gadgets.
  16.  
  17.      2)  For a fully operational LoGG you will need the following files in
  18. your current "c" directory:
  19.  
  20.       ARC, CD, EDIT, ENDCLI, LHARC, LoGG.file, PAK, RUN, STACK, WARP, ZOO
  21.  
  22.      You must name these files exactly as above.  For example, EDIT is 
  23. your favourite editor program.  The files CD, ENDCLI, RUN and STACK are your
  24. usual Workbench files.
  25.  
  26.      3)  Click into a vertical gadget to make the corresponding window the
  27. SOURCE window.  When SOURCE and DESTINATION are the same, do not try to
  28. copy from one to the other because you cannot copy a file to itself.
  29.  
  30.      4)  Click fast twice on the name of a directory in order to attach to
  31. it.  If a DRIVE is not listed in your list of 14 drives, and you want to
  32. see it, just enter the desired pathname into the "D" or "S" gadget and press
  33. <RETURN>.
  34.  
  35.      5)  Configure LoGG so that it carries your own 4 colors and your own 14
  36. drives.  Attach to a place where you can find your palette.  Run the palette
  37. by selecting it first and then clicking into LoGG's RUN gadget.  Change 
  38. any of the 4 colors on the palette (you get 3 HEX numbers for each color),
  39. and then place those 12 numbers in the third line of your LoGG.file.
  40.      To place your own drives in LoGG, just enter 14 drive names into the
  41. first two lines of your LoGG.file.  You may repeat drive names of course.
  42.      After you have made any change to your LoGG.file while you are running
  43. LoGG, just choose the CONFIGURE item of the first menu to get LoGG to adjust
  44. itself to the change.
  45.  
  46.      6)  Study the file LoGG.file so that you can create up to 48 gadgets
  47. with your own titles and your own commands.  
  48.      The titles of the gadgets should be at most 8 characters long.
  49.      The corresponding title entries in the file LoGG.file should be exactly
  50. 10 characters long, like "DPAINT   *", "CONTOURA *", etc.  You should not
  51. include the quotes in your LoGG.file.
  52.      The MACROS (Entries 1 - 24 in your LoGG.file) can accommodate up to 
  53. 7 different command lines each.
  54.      Only the first token of the first command line of a MACRO can be "CD".
  55.      The PARMS (Entries 25 - 48 in your LoGG.file) can only carry one 
  56. command line.  This command line can have up to 5 tokens and at most 2 para-
  57. meters.  For example,
  58.  
  59.            "FIXOBJ %s %s (R)", "HELLO %s HERMES %s JULIE (R)", "EDITOR %s"
  60.  
  61. are acceptable PARMS command lines.  If there are two parameters (%s) in a
  62. PARMS command, the first one is a highlighted file and the second is a
  63. string that you enter in the file requestor.  If there is only one parameter
  64. in your command line, there are two possibilities: 1) If there is a file
  65. selected (highlighted), LoGG will pick the name of that file for this para-
  66. meter.  2) If there is no selected file, LoGG will bring the requester out
  67. for you to enter a string for this parameter.
  68.      The symbol "(R)" here means that you want to have the file listing
  69. refreshed after the execution of this command.  The symbol "(R)" must be
  70. placed at the end of your command and at least one space away from the last
  71. word/symbol in your command.
  72.      After you have made any change to your LoGG.file while you are running
  73. LoGG, just choose the CONFIGURE item of the first menu to get LoGG to adjust
  74. itself to the change.
  75.  
  76.      7)  Sometimes your LoGG.file gets funny with some, possibly invisible,
  77. characters in it.  To correct it, just run the file FIX_FILE.  This file
  78. will attempt to correct your LoGG.file and put the corrected contents in
  79. a file called LoGG.file1.  Just rename LoGG.file1 as LoGG.file and continue
  80. as usual.
  81.  
  82.      8)  IMPORTANT!  Do not forget that you can stop the SEARCHING OF FILES
  83. AND STRINGS, CATALOGING, COPYING AND MOVING OF FILES, etc., by just
  84. clicking into the STOP BUTTON on your front panel.
  85.  
  86.      9)  To make one of the two windows on your front panel the SOURCE
  87. window, just click into its vertical gadget or anywhere into it.  Then the 
  88. other window will automatically become the DESTINATION window.
  89.  
  90.      10)  To copy files from one of the display windows into another path
  91. not currently on display in the opposite window, you can just enter that
  92. path in the DESTINATION BUFFER "D" and click into the COPY gadget.  When
  93. copying is finished, LoGG will list that destination path.  The same remark
  94. applies to the MOVE operation.
  95.  
  96.      11)  Pressing QUIT while FORMATTING/DISKCOPYING might corrupt the desti-
  97. nation disk.  Do not use QUIT (on the FORMAT/DISKCOPY requester) unless
  98. it is absolutely necessary.
  99.  
  100.      12)  READ: This is a fully operational file reader.  It will list
  101.           the selected file and will scroll through it very fast.  It
  102.           has 8 menu items.  We will only elaborate on the items that
  103.           need some explanation.  Just remember that YOU CAN SCROLL
  104.           THE TEXT UP AND DOWN BY USING THE RESPECTIVE ARROW KEYS or by
  105.           CLICKING into the upper or lower half of the reader screen.
  106.     
  107.                (1) GO TO LINE:  You can choose this menu item, or just
  108.                    press RIGHT_AMIGA-G instead.  As soon as you do that,
  109.                    the GOTO-gadget clears up.  Just go ahead and type
  110.                    in the line number you want to see.  Then press
  111.                    <RETURN>.  The program will then try to exhibit that line
  112.                    as the top line of the page.  Another way of doing this:
  113.                    Just click into the GOTO-gadget, clear it up by using
  114.                    the BACKSPACE key (or pressing RIGHT_AMIGA-X), enter
  115.                    the line number that you wish to exhibit, and then press
  116.                    <RETURN>.
  117.                    The program will do nothing if the line number that you 
  118.                    have entered does not exist.
  119.                     
  120.  
  121.                (2) FIND STRING:  You can choose this menu item, or just
  122.                    press RIGHT_AMIGA-F instead.  As soon as you do that,
  123.                    the FILE-gadget clears up.  Just go ahead and type
  124.                    in the string that you want to see.  Then press
  125.                    <RETURN>.  The program will then try to exhibit that
  126.                    string at the top line of the page.  Another way of doing 
  127.                    this: Just click into the FILE-gadget, clear it up by 
  128.                    using the BACKSPACE key (or pressing RIGHT_AMIGA-X),
  129.                    enter the string that you wish to exhibit, and then
  130.                    press <RETURN>.
  131.                    The program will do nothing if the string that you have
  132.                    entered does not exist from the current line on.
  133.  
  134.                (3) SEARCH AGAIN:  Well, now that you have found the string,
  135.                    just choose this menu item or press RIGHT_AMIGA-S to
  136.                    try to find the string again.  The program will try to
  137.                    locate the string and exhibit it at the top line of 
  138.                    the page.  Again, the program tries to locate the given
  139.                    string starting from the secong line of your page down
  140.                    to the end of the file.
  141.                 
  142.      13)  You should change to HIRES (clicking into the RESOL gadget) if
  143. you have more than 800 files in the same directory listing.  Otherwise you
  144. will get a partial listing of these files.  If you are using the MEDIUM re-
  145. solution mode and LoGG finds out that there are more than 800 files in your
  146. directory, LoGG will inform you that you should change into the HIRES mode.
  147.  
  148.      14)  The STOP button does stop a file from being printed to your
  149. printer, but it takes some time before the Amiga responds to the signal
  150. to stop.  So, be a little patient.
  151.  
  152.      15)  If you get a little confused about the exact name of a file which
  153. is not completely listed, just select the file and click into the FILEINFO
  154. gadget.  The FILEINFO gadget contains the entire name of the file and
  155. information on the file's Protection Bits, Comment and Date of creation.
  156.  
  157.      16)  Whenever a CLI appears in the execution of a command or in an 
  158. archiving process, you should close it by pressing EndCLI.  It is important
  159. that you have this command included in your "c" directory.
  160.  
  161.      17)  If you change your LoGG icon (this is the program icon, not the
  162. disk icon), please remember to enter the data in the TOOL TYPES gadget in 
  163. the new icon as they appear in the original one.
  164.      The icon that LoGG comes with opens a 1-pixel window on your WorkBench
  165. just in case LoGG needs to put some output somewhere.  If you do not take
  166. care of this, LoGG may crash your machine when it tries to write an error
  167. statement into a nonexistent window.
  168.